Release 10.1A: OpenEdge Development:
Messaging and ESB

setErrorHandler procedure

Sets the error-handling procedure.

Syntax

PROCEDURE setErrorHandler. DEFINE INPUT PARAMETER messageConsumer AS HANDLE.

Applies to

Session objects

Notes

The application must create the error-handling messageConsumer object and call the setErrorHandler procedure after calling the beginSession procedure. If the application does not call the setErrorHandler procedure, a default error handler displays the error message and the properties in alert boxes.
The application should handle asynchronously reported error conditions programmatically by creating an error-handling Message Consumer object and passing it to the setErrorHandler procedure in the Session object. The setErrorHandler procedure creates an error-handling Message Consumer object.
Asynchronous conditions are always reported as a TextMessage with several possible CHARACTER message properties. The CHARACTER properties that might be included in the message header are: exception, errorCode, linkedException-1, linkedException-2 … linkedException-n (where n is a number of additional exceptions linked to the main exception).
The getPropertyNames function can be used to get the list of properties in the error message header.

See also

setErrorHandler procedure, setNoErrorDisplay procedure

For more information, see the "Error and condition handling" section. For an example, see the Appendix B "Messaging Examples."